home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 014 / arca122.arc / ARCA122.DOC < prev    next >
Text File  |  1986-09-18  |  8KB  |  180 lines
  1.  
  2. ARCA Command
  3. ------------
  4.  
  5. Purpose:  To create or add files to an ARC archive file.
  6.  
  7. Format:   ARCA  [drive:][path]arcname.ext  [filespecs...]  [/d]
  8.  
  9. Remarks:  The drive and path names are optional. If omitted, the
  10.         current drive and path name are used.
  11.  
  12.         The 'arcname' file name must be supplied.  The extension
  13.         defaults to ARC.  All files matching the supplied filespecs are
  14.         processed.  The input 'filespecs' may contain the * and ?
  15.         wildcard characters.
  16.  
  17.         If an existing archive file is used, the specified input
  18.         files are added to the end of it. There is no checking
  19.         for duplicate filenames and existing archive member files
  20.         are not replaced.  ARCA is best used when creating a brand-new
  21.         archive.
  22.  
  23.         The /D option specifies that all input files be deleted.  The
  24.         files are deleted after successful processing of all of the
  25.         input files.
  26.  
  27.         Invoking ARCA with no arguments yields a terse summary of
  28.         the needed parameters, along with a version header.
  29.  
  30.         ARCA uses only 2 compression techniques: a modified LZW
  31.         compression algorithm and repeated-string compression
  32.         ("packing").  The LZW algorithm is the same as the one used by
  33.         ARC, but modifications have been made to improve its compression
  34.         performance, especially when dealing with files containing
  35.         more "random" data such as executable files, though compression
  36.         performance for files containing less random data such as
  37.         textual files suffers a bit, but not much.  ARCA generally
  38.         performs better than ARC does -- it's significantly faster than
  39.         ARC while yielding smaller archives (hard to imagine getting
  40.         the best of two worlds!)
  41.  
  42.         Experiments have shown that the modified LZW compression algorithm
  43.         generally compresses binary files better than the Huffman algorithm
  44.         ("squeezing") can, Huffman compression is not used at all. If the
  45.         LZW compression fails to yield a smaller file, then packing is used
  46.         instead.  There are cases where a packed file is larger than the
  47.         original file, but these cases don't happen often enough for ARCA to
  48.         handle, for example, by copying the unchanged file to the archive.
  49.  
  50.         Though ARCA uses an improved LZW algorithm, its output is TOTALLY
  51.         compatible with the one used by System Enhancements Associates'
  52.         (21 New Street, Wayne NJ 07470) ARC program, which means that ARC's
  53.         created by ARCA can be processed by ARC or by ARCE and ARCV
  54.         (companion extraction & table-of-contents lister programs also
  55.         written by Vernon Buerg and Wayne Chin).
  56.  
  57.         As mentioned, ARCA is intended to be used to create a NEW archive,
  58.         not for appending or updating an existing archive, though ARCA does
  59.         not prevent you from doing so -- ARCA simply appends new files to the
  60.         named archive without deleting existing entries.  To properly append
  61.         or to update, you should use ARC instead. If there's sufficient clamor
  62.         for ARCA to be able to update existing archives, then the feature
  63.         will be added.  Cast your vote by contacting the BBS at the number
  64.         listed at the end of this document.
  65.  
  66. |       There are two COM files. The ARCA286.COM file is for 80286 based
  67. |       systems only.
  68.  
  69.  Examples:
  70.  --------
  71.  
  72.         o  Create an archive file called TEST.ARC, and place all
  73.            files from the current directory into it:
  74.  
  75.               ARCA TEST *.*
  76.  
  77.         o  Create an archive called SOURCE.ARC in the subdirectory
  78.            \SAVE on drive B, and place all files with an extension
  79.            of ASM into to:
  80.  
  81.               ARCA B:\SAVE\SOURCE *.ASM
  82.  
  83.  
  84.         o  Add files to the archive on drive A called PROGA.ARC all
  85.            files in subdirectory \TEST on drive C, all files with a
  86.            filename beginning with NE, and all file from the subdirectory
  87.            \OLD on drive B:
  88.  
  89.               ARCA A:PROGA.ARC C:\TEST\*.* NE*.* B:\OLD\*.*
  90.  
  91.  
  92.  Error Messages:
  93.  --------------
  94.  
  95.     ARCA: filename, analyzing, compressed.
  96.         This message is issued for each 'filename' added to
  97.         the archive file using LZW data compression. The program
  98.         continues.
  99.  
  100.     ARCA: filename, analyzing, packed.
  101.         This message is issued for each 'filename' added to
  102.         the archive file using repeated-string compression.  The
  103.         program continues.
  104.  
  105.     ARCA: No matching files!
  106.         No files were found that matched one of the 'filespecs'
  107.         in the command line. The program terminates.
  108.  
  109.     ARCA: You must use DOS version 2.0 or higher.
  110.         DOS version 2.0 or higher is required. The program terminates.
  111.  
  112.     ARCA: Insufficient memory.
  113.         A minimum of 34k is required. The program terminates.
  114.  
  115.     ARCA: Shrink failed.
  116.         This error should not occur. If it does, there is a problem
  117.         with DOS. The program terminates.
  118.  
  119.  
  120.     ARCA: Can't create archive file.
  121.         There is no room in the target directory to create the
  122.         specified archive file, or the target disk has become full.
  123.  
  124.     ARCA: Write error -- no more disk space? Don't trust this archive!
  125.         ARCA has encountered a problem writing to the target disk.  Check
  126.         if there's sufficient room on the target disk to contain the full
  127.         archive or delete unneeded files to free up some space.  ARCA
  128.         terminates leaving behind an archive that may not be usable --
  129.         check it carefully if you still want to use it (check the archive
  130.         by using ARCV or ARCE).
  131.  
  132.  Version history:
  133.  ---------------
  134.  
  135.         1.07 - 4/21/86
  136.                 initial release
  137.         1.08 to 1.13
  138.                 internal versions
  139.         1.14 - 08/07/86
  140.                 add logic to sort input files using binary tree;
  141.                 modify filtering of ARC name when adding to ARC;
  142.                 modify processing of "/D" switch;
  143.                 do packing of file if LZW compression does no good;
  144. |               add optional code for 286 processor
  145.         1.15, August 08, 1986
  146.                 more 286-specific instructions
  147.         1.16, August 09, 1986
  148.                 more 286-specific instructions in compression code
  149.         1.17, August 10, 1986
  150.                 speed improvements in compression code
  151.         1.17a, August 10, 1986
  152.                 bug fix for the case of "arca x d:*.*", where d is not
  153.                 the current drive
  154.         1.18, August 11, 1986
  155.                 further speed tweaking in compression code; save a few
  156.                 more nanoseconds
  157.         1.19 to 1.21
  158.                 internal versions not released for general consumption
  159. |       1.22, Sept 13, 1986
  160. |               improve error handling
  161. |               improve speed performance roughly 9%
  162. |               very modest compression perfomance improvement
  163. |               modify this document accordingly
  164.  
  165.  
  166.  Notice:
  167.  ------
  168.         Copyright (c) Wayne Chin and Vernon Buerg 1986;
  169.         for the IBM PC using DOS 2.0 or later. All rights reserved.
  170.  
  171.         For personal, private use. Not for sale or hire.
  172.  
  173.                 Vernon D. Buerg
  174.                 456 Lakeshire Drive
  175.                 Daly City, CA  94015
  176.                 CompuServe: 70007,1212
  177.                 Data/BBS:   415-994-2944
  178.                 Fidonet:    125/4
  179.  
  180.